4D Doc Center : CT Area to picture

4D Chart v13

CT Area to picture


CT Area to picture ( area ; scope ) -> Function result

Parameter	Type	Description
area	Longint	4D Chart area
scope	Longint	Scope of the function -2 = Document -1 = All 0 = Selected objects >0 = Object ID
Function result	Picture	4th Dimension picture of the objects in area

Description

CT Area to picture returns a 4D picture of the objects in area.

The objects included in the picture are controlled by the scope parameter.

If scope equals -2, the entire document is copied. This includes document settings such as display options.
If scope equals -1, all objects in area are copied but without document settings.
If scope equals 0, only the selected objects are copied.
If scope is greater than 0, it must equal a specific object’s ID and only that object is copied.

Example

This example opens a new offscreen area, creates a bar chart from existing arrays, stores the chart in a picture variable, and finally, deletes the offscreen area.

 Area:=CT New offscreen area

 vChart:=CT Chart arrays(Area;2;2;aCategory;aSeries;aValues)

 vPict:=CT Area to picture(Area;vChart)

 CT DELETE OFFSCREEN AREA(Area)